8.1.2 创建法币支付订单

#简要描述：获取现金（法币）支付（充值）订单

请求方式: POST
请求接口: https://网关域名/wallet-trade-merchant/v1/receive/cash/payment/create
请求媒体类型( JSON 数据格式 )Content-Type: application/json

注：此类型订单在回调过程中，可能因我方平台延迟收到款项而导致订单超时，从而产生失败回调。但当款项到账后，系统会自动补发成功回调。因此，商户仅需处理 status = "SUCCESS"（订单成功）的回调即可。

请求参数

参数名称	类型	必填	参数含义	参数说明
key	string	是	商户 key	apiKey
localOrderId	string	是	商户平台本地订单号	商户平台本地生成唯一订单号
localUserId	string	否	商户平台本地用户ID	商户平台本地用户ID
notifyUrl	string	否	回调地址	下单成功后，由 API 回调通知商户的地址（回调详情说明在最下方）
successRedirectUrl	string	否	跳转地址	成功后自动跳转地址
channelCode	string	是	渠道编码	通过文档8.1.1接口获取渠道编码（channelCode字段）
currency	string	是	币种	订单计价币种
amount	number	是	金额	订单计价金额
localUserRealName	string	否	本地用户真实姓名
sign	string	是	签名	详情见签名算法

请求 json 样例

{
 "key": "dNNTJZpgFVWlYrVv",
 "localOrderId": "conantest344",
 "localUserId": "conan",
 "notifyUrl": "http://127.0.0.1:8080/merchant-demo/notify/test",
 "isBlockchain": true,
 "channelCode":"tencentest9",
 "currency": "CNY",
 "amount": "100",
 "localUserRealName":"柯南",
 "sign": "9662c0f104123b0ccac049108f174589"
}

响应 json 示例

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
           "orderId": 352950471221317,
           "localOrderId": "conantest344",
           "uiUrl": "http://im.topup.dianfus.dx.com/imserver/chat/Yy9kQ3IvVXNta3BwWE5sUzUvYVM3M2hHU0UrNjlnSzRjdVpGa1BHWmR1RUdLU0daa3pDNjZqbm1QOTRlUnRULzI5TmNyWFhjV2xJc3ZGZFVzdTFWY2tkWHF1Tk1yeUxDajFod01QRk83K2FrVnIvRm1YY0ZpUzBOK001NEZXbXhzd0ZxdzhPUVFlaGlaTCttbFdML04wb3VPZ3kvUDFkdHJISlhwVjlXVE1JPQ=="
           }
}

响应data 参数说明

参数名称	类型	参数含义
orderId	long	订单ID
localOrderId	string	商户平台本地订单号
uiUrl	string	支付链接地址

回调详情说明

注：此类型订单商户在处理回调通知时，可能因我方平台延迟收到款项，导致代收订单超时，从而触发订单失败的回调通知。当款项实际到账后，系统会自动补发成功回调。 因此，对于此类订单，商户只需以 status = "SUCCESS"（订单成功）的回调作为最终有效结果进行处理。

回调的方式是：POST application/json

回调参数 json 化示例

{
 "amount":"100",
 "currency":"CNY",
 "localOrderId":"conantest344",
 "merchantId":302992856974,
 "merchantUserId":"conan",
 "notifyTime":1757577957437,
 "orderCreateTime":1757577574425,
 "orderId":"352950471221317",
 "paidAmount":"100",
 "status":"SUCCESS",
 "type":"PAYMENT",
 "isReissue":"true",
 "sign":"774720acbacafca99af62b98d72154d3",
 "key":"9yUreYgTRtit39Dy"
}

参数名称	类型	参与签名	参数含义	参数说明
amount	decimal	是	订单金额
currency	string	是	币种
localOrderId	string	是	商户本地订单号
merchantId	string	是	商户ID
merchantUserId	string	是	商户平台本地用户ID
notifyTime	long	是	回调时间	毫秒
orderCreateTime	long	是	订单创建时间	毫秒
orderId	string	是	订单号
paidAmount	decimal	是	支付金额
status	string	是	订单状态	SUCCESS:已完成 \| FAIL:已失败
type	string	是	订单类型	PAYMENT支付、WITHDRAW 提款
isReissue	boolean	是	是否补发	ture 是｜ false 否
sign	string	否	md5 签名	详情看签名算法
key	string	是	商户 key

当您收到回调通知后，请在处理完成后直接返回字符串 success，表示已成功接收并处理该消息。系统在收到 success 响应后，将不再对该笔回调进行重复发送。若未收到期望响应（未返回 success 或返回异常），系统将按照阶梯式重试机制重新发送回调通知，最多重试 14 次。当前重试时间间隔依次为： 15s, 15s, 30s,180s, 600s, 1200s, 1800s, 1800s, 1800s,3600s,10800s,10800s,21600s, 21600s

请求参数​

请求 json 样例​

响应data 参数说明​

回调详情说明​

回调的方式是：POST application/json​